Operator CLHSDualCamera

Operator Library: Hardware Platform

This operator represents the image data interface between a CLHS Dual Link configuration camera and VisualApplets. This operator receives data from the CLHS Dual Link configuration camera and feeds it into the image processing application.

Available for Hardware Platform
marathon VF2

The operator uses both resources of type camera exclusively. More camera resources cannot be used in the applet.

The operator provides image data on its output port O. This output port is always present.

In addition to this standard output port, you can specify various optional ports if required by your design.

The CLHS protocoll supports pulses and GPIO messages.

During instantiation of the operator, a pop-up dialog appears:

Here, you can define the availability of up to 16 optional GPIs (General Purpose Inputs) and up to 16 optional GPOs (General Purpose Outputs).

In addition, you can activate one output port Output (SyncO) (MultiFGSync bit of video message).

If you set the port availability to "0" (default), the port will not be present in the operator. If you set the port availability to 1, the particular port is available at the operator interface.

The GPIO state is transferred when the state of a GPI is changed by a connected operator. When the operator receives a GPIO message from the camera, all GPOs are updated.

GPIO messages are only exchanged on channel 0. On channel 1 there is no communication of this kind.

Parameter Bit Width can be set to a value higher or lower than the bit width the camera is actually sending.

If you select a lower value, the LSB bits of each pixel are cut off, so that only the MSB bits are transferred into the application.

If you select a higher value, the original pixel is set to the MSB position of the outgoing pixel. The LSB bits are filled with zeros.

In both cases, the relative brightness remains the same, i.e., white pixels remain white and dark pixels remain dark.

I/O Properties

Property Value
Operator Type M
Input Link GPI0...GPI15 (optional), status of the frame grabber GPOs (exchange via CLHS)
Output Links O, acquisition image data to be used inside VisualApplets
GPO0...GPO15 (optional), status of the camera GPOs (exchange via CLHS)
SyncO, MultiFGSync bit is set in video package (valid for 1 clock cycle)

Supported Link Format

Link Parameter Output Link O Output Link GPO0...GPO15 (optional) Input Link GPI0...GPI15 (optional) Output Link SyncO
Bit Width any 1 1 1
Arithmetic unsigned unsigned unsigned unsigned
Parallelism any, see parameter description 1 1 1
Kernel Columns 1 1 1 1
Kernel Rows 1 1 1 1
Img Protocol {VALT_IMAGE2D, VALT_LINE1D} VALT_SIGNAL VALT_SIGNAL VALT_SIGNAL
Color Format VAF_GRAY VAF_GRAY VAF_GRAY VAF_GRAY
Color Flavor FL_NONE FL_NONE FL_NONE FL_NONE
Max. Img Width any 1 1 1
Max. Img Height any 1 1 1

Parameters

CameraID
Type static write parameter
Default 0
Range 0

The parameter specifies which camera resource is used. Furthermore, the ID will be used to map camera channels to applet ports.

PixelFormat
Type static write parameter
Default Mono10p
Range {Mono8,Mono10p,Mono12p,Mono14p,Mono16,Raw8,Raw10p,Raw12p,Raw14p,Raw16, Raw64, B8, B10p, B12p, B14p, B16, G8, G10p, G12p, G14p, G16, R8, R10p, R12p, R14p, R16, BGR8, BGR10p, BGR12p, BGR14p, BGR16, BGRa8, BGRa10p, BGRa12p, BGRa14p, BGRa16, BayerGR8, BayerGR10p, BayerGR12p,BayerGR14p, BayerGR16, BayerRG8, BayerRG10p, BayerRG12p, BayerRG14p, BayerRG16, BayerGB8, BayerGB10p, BayerGB12p, BayerGB14p, BayerGB16, BayerBG8, BayerBG10p, BayerBG12p, BayerBG14p, BayerBG16}

The parameter specifies the output pixel format.

AquisitionFormat
Type static write parameter
Default Area
Range {Area; Linescan}

When this parameter is set to "Area", the first data available is a complete frame. Frames started in the middle will be ignored. Therefor a "Start Of Frame" in the first video message is required. In "linescan" mode, Start/End of Frame will be ignored, since they are set to 0 for linescan cameras.

MinimalParallelism
Type static read parameter
Default 16
Range [1; 1024]

Minimal parallelism for the output link O to be able to transport the maximal bandwidth of the camera without losing data. This value depends on the currently selected design clock frequency. The higher the frequency the lower the parallelism value can become.

LineSupervision
Type dynamic/static read/write parameter
Default off
Range {on, off}

Consistent check for lines. Checks if RowIDs following by RowStep steps. Furthermore check for integrity: Start of line (SoL) and End of Line (EoL) must be in the correct order. Missing EoL or SoL will be detected, an error flag is generated and an End of Line is inserted. Missing Lines will be inserted as smaller lines (length depends on parallelism and bitwidth) until 2 following RowIDs are detected and line consistency is guaranteed again.

RowStep
Type dynamic/static read/write parameter
Default 1
Range {1, 65535}

Step between 2 RowIDs. Should be 1 unless a multi-channel camera is used and lines are split amongst links.

OverflowOccurred
Type dynamic read parameter
Default 0
Range [0;1]

This parameter signalizes that the internal FIFO has an overflow. Overflow indicates loss of data and need to be avoided. Possible reasons might be: One link is not sending at all, or the data is received faster than it can be processed by the operator.